home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Xm / XmeSecondarySink.z / XmeSecondarySink
Text File  |  1998-10-30  |  9KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSiiiinnnnkkkk((((3333XXXX))))      UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV      XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSiiiinnnnkkkk((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSiiiinnnnkkkk - A toolkit function that establishes a
  10.           widget as the destination for secondary transfer
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           #include <Xm/TransferP.h>
  14.           BBBBoooooooolllleeeeaaaannnn XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSiiiinnnnkkkk(
  15.           WWWWiiiiddddggggeeeetttt wwwwiiiiddddggggeeeetttt,
  16.           TTTTiiiimmmmeeee ttttiiiimmmmeeee);
  17.  
  18.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  19.           This page documents Motif 2.1.
  20.  
  21.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.           XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSiiiinnnnkkkk establishes a widget as the destination for
  23.           secondary transfer operations.  When the VVVVeeeennnnddddoooorrrrSSSShhhheeeellllllll
  24.           XXXXmmmmNNNNkkkkeeeeyyyybbbbooooaaaarrrrddddFFFFooooccccuuuussssPPPPoooolllliiiiccccyyyy is XXXXmmmmEEEEXXXXPPPPLLLLIIIICCCCIIIITTTT, the destination is the
  25.           editable component that last had focus.  When the
  26.           VVVVeeeennnnddddoooorrrrSSSShhhheeeellllllll XXXXmmmmNNNNkkkkeeeeyyyybbbbooooaaaarrrrddddFFFFooooccccuuuussssPPPPoooolllliiiiccccyyyy is XXXXmmmmPPPPOOOOIIIINNNNTTTTEEEERRRR, the
  27.           destination is the editable component that last received
  28.           mouse button or keyboard input.
  29.  
  30.           XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSiiiinnnnkkkk establishes a widget as the destination by
  31.           taking ownership of the ____MMMMOOOOTTTTIIIIFFFF____DDDDEEEESSSSTTTTIIIINNNNAAAATTTTIIIIOOOONNNN selection.
  32.  
  33.           XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSiiiinnnnkkkk also establishes a function that is called
  34.           when the widget loses the selection.  That function makes
  35.           the following sequence of calls:
  36.  
  37.              1. Calls the widget's XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures, if
  38.                 any.  XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSiiiinnnnkkkk passes an
  39.                 XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuuccccttttto each of these
  40.                 XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures.  XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSiiiinnnnkkkk
  41.                 initializes the XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuuccccttttas follows:
  42.  
  43.                    +o  Sets the _s_e_l_e_c_t_i_o_n member to ____MMMMOOOOTTTTIIIIFFFF____DDDDEEEESSSSTTTTIIIINNNNAAAATTTTIIIIOOOONNNN
  44.  
  45.                    +o  Sets the _t_a_r_g_e_t member to ____MMMMOOOOTTTTIIIIFFFF____LLLLOOOOSSSSEEEE____SSSSEEEELLLLEEEECCCCTTTTIIIIOOOONNNN
  46.  
  47.              2. Calls the source widget's ccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc trait method.
  48.                 However, if any XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedure returns
  49.                 XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____DDDDOOOONNNNEEEE or XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____RRRREEEEFFFFUUUUSSSSEEEE, then
  50.                 XXXXmmmmeeeePPPPrrrriiiimmmmaaaarrrryyyySSSSoooouuuurrrrcccceeee will not call ccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc.
  51.  
  52.           _w_i_d_g_e_t    Specifies the widget that is to be the
  53.                     destination.
  54.  
  55.           _t_i_m_e      Specifies the time of the transfer.  This is
  56.                     usually the timestamp from the event passed to an
  57.                     action routine.  You should call
  58.                     _X_t_L_a_s_t_T_i_m_e_S_t_a_m_p_P_r_o_c_e_s_s_e_d to generate the
  59.                     _t_i_m_evalue.  If you set _t_i_m_e to CCCCuuuurrrrrrrreeeennnnttttTTTTiiiimmmmeeee or 0,
  60.  
  61.  
  62.  
  63.      Page 1                                         (printed 10/24/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSiiiinnnnkkkk((((3333XXXX))))      UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV      XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSiiiinnnnkkkk((((3333XXXX))))
  71.  
  72.  
  73.  
  74.                     UTM will automatically change the call to
  75.                     _X_t_L_a_s_t_T_i_m_e_S_t_a_m_p_P_r_o_c_e_s_s_e_d.
  76.  
  77.      RRRREEEETTTTUUUURRRRNNNN
  78.           This function returns False if the widget cannot take
  79.           ownership of the ____MMMMOOOOTTTTIIIIFFFF____DDDDEEEESSSSTTTTIIIINNNNAAAATTTTIIIIOOOONNNN selection.  Otherwise,
  80.           it returns True.
  81.  
  82.      RRRREEEELLLLAAAATTTTEEEEDDDD
  83.           XXXXmmmmQQQQTTTTttttrrrraaaannnnssssffffeeeerrrr(3), XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrDDDDoooonnnneeee(3), XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrVVVVaaaalllluuuueeee(3),
  84.           XXXXmmmmeeeeCCCClllliiiippppbbbbooooaaaarrrrddddSSSSiiiinnnnkkkk(3), XXXXmmmmeeeeCCCClllliiiippppbbbbooooaaaarrrrddddSSSSoooouuuurrrrcccceeee(3),
  85.           XXXXmmmmeeeeCCCCoooonnnnvvvveeeerrrrttttMMMMeeeerrrrggggeeee(3), XXXXmmmmeeeeDDDDrrrraaaaggggSSSSoooouuuurrrrcccceeee(3), XXXXmmmmeeeeDDDDrrrrooooppppSSSSiiiinnnnkkkk(3),
  86.           XXXXmmmmeeeeGGGGeeeettttEEEEnnnnccccooooddddiiiinnnnggggAAAAttttoooommmm(3), XXXXmmmmeeeePPPPrrrriiiimmmmaaaarrrryyyySSSSiiiinnnnkkkk(3),
  87.           XXXXmmmmeeeePPPPrrrriiiimmmmaaaarrrryyyySSSSoooouuuurrrrcccceeee(3), XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSoooouuuurrrrcccceeee(3),
  88.           XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyyTTTTrrrraaaannnnssssffffeeeerrrr(3), XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddCCCCoooonnnnvvvveeeerrrrtttt(3),
  89.           XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddTTTTaaaarrrrggggeeeettttssss(3), and XXXXmmmmeeeeTTTTrrrraaaannnnssssffffeeeerrrrAAAAddddddddDDDDoooonnnneeeePPPPrrrroooocccc(3).
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                         (printed 10/24/98)
  130.  
  131.  
  132.  
  133.